monitoring-tools-ux
Update Ticket Details from ACUT to Salesforce
/{businessId}/troubleTicket/{id}
[PATCH]
Update comments, contact phone number, queue, status and closing comments in Salesforce from ACUT.
URL
https://[localhost]:[port]/monitoring-tools-ux/v1/{businessId}/troubleTicket/{id}Param
| name | type | description | required |
|---|---|---|---|
| businessId | string | 2 letter ISO 3166 country code (TT, BB, JM, HN, CR, DO etc..) identifying the business unit. Expected:JM,AI,AG,VG,KY,DM,GD,MS,KN,LC,VC,TC | Y |
| id | string | Salesforce Case Id | Y |
Header
| name | value | description | required |
|---|---|---|---|
| client_id | string | The client_id identifying the channel. | Y |
| client_secret | string | Password associated with the client_id. | Y |
| X-Correlation-ID | string | Identifier that correlates HTTP request between a client and server. Any identification model (UUDI, checksum, etc.) can be used, as long as it is a unique value to differentiate a transaction. Note - Mule default behavior creates a sample x-correlation-id field if value is not passed from client, API will use this value in case value is not passed in API request syntax: correlationId: uuid:cwc--, example: correlationId: f058ebd6-02f7-4d3f-942e-904344e8cde5:cwc--qa | Y |
Salesforce tenants
| SF Environment to Connect | SF Instance |
|---|---|
| QA | cwc--qa |
| UAT | cwc--uatsfdc |
| Production | cwc--prod |
Body Definitions
| name | type | description | required |
|---|---|---|---|
| channel.id | string | Default: For ACUT-> ACUT | Y |
| channel.@type | string | Default: ChannelRef | Y |
| note[].id | string | Default: Comment | Y |
| note[].text | string | Comment for the ticket | Y |
| note[].@type | string | Default: Note | Y |
| note[].id | string | Default: ClosingComment | Y |
| note[].text | string | Closing comments | Y |
| note[].@type | string | Default: Note | Y |
| relatedParty[].id | string | Salesforce Contact id | Y |
| relatedParty[].@schemaLocation | string | Default: 'https://github.com/tmforum-apis/Open_Api_And_Data_Model/blob/master/schemas/EngagedParty/RelatedPartyWithContactInfo.schema.json' | Y |
| relatedParty[].@type | string | Default: RelatedPartyWithContactInfo | Y |
| relatedParty[].role | string | Default: contact | Y |
| relatedParty[].@referredType | string | Default: Individual | Y |
| relatedParty[].contactMedium[].@referredType | string | Default: TelephoneMedium | Y |
| relatedParty[].contactMedium[].mediumType | string | Default: TelephoneNumber | Y |
| relatedParty[].contactMedium[].characteristic.phoneNumber | string | Contact phone number | Y |
| relatedEntity[].id | string | Assigned user id /queue id | Y |
| relatedEntity[].role | string | Default: AssignedGroup | Y |
| relatedEntity[].@referredType | string | Default: Organization | Y |
| relatedEntity[].id | string | Salesforce appointment id | Y |
| relatedEntity[].description | string | Reason for appointment | Y |
| relatedEntity[].validFor.startDateTime | datetime | Start datetime of appointment | Y |
| relatedEntity[].validFor.endDateTime | datetime | End datetime of appointment | Y |
| relatedEntity[].role | string | Default: requestedAppointment | Y |
| relatedEntity[].@type | string | Default: RelatedEntity | Y |
| relatedEntity[].@referredType | string | Default: Appointment | Y |
| troubleTicketCharacteristic[].name | string | name of the characteristic. Default:externalStatus | Y |
| troubleTicketCharacteristic[].value | string | value of characteristic. Status of the ticket | Y |
Sample Request
{
"note": [
{
"id": "Comment",
"text": "string",
"@type": "Note"
},
{
"id": "ClosingComment",
"text": "string",
"@type": "Note"
}
],
"channel": {
"id": "ACUT",
"@type": "ChannelRef"
},
"relatedEntity": [
{
"id": "O",
"role": "AssignedGroup",
"@referredType": "Organization"
},
{
"id": "00Tdq000006UkI5EAK",
"description": "CUSTOMER REQUESTED",
"validFor": {
"startDateTime": "2019-12-05T05:30:00.000+05:30",
"endDateTime": "2019-12-05T06:30:00.000+05:30"
},
"role": "requestedAppointment",
"@type": "RelatedEntity",
"@referredType": "Appointment"
}
],
"relatedParty": [
{
"id": "003dq000004yL0rAAE",
"@schemaLocation": "https://github.com/tmforum-apis/Open_Api_And_Data_Model/blob/master/schemas/EngagedParty/RelatedPartyWithContactInfo.schema.json",
"@type": "RelatedPartyWithContactInfo",
"role":"contact",
"@referredType": "Individual",
"contactMedium": [
{
"@referredType": "TelephoneMedium",
"mediumType": "TelephoneNumber",
"characteristic": {
"phoneNumber": "8879541292"
}
}
]
}
],
"troubleTicketCharacteristic": [
{
"name": "externalStatus",
"value": "assigned"
}
]
}Sample Response
{
"note": [
{
"id": "Comment",
"text": "string",
"@type": "Note"
},
{
"id": "ClosingComment",
"text": "string",
"@type": "Note"
}
],
"channel": {
"id": "ACUT",
"@type": "ChannelRef"
},
"relatedEntity": [
{
"id": "O",
"role": "AssignedGroup",
"@referredType": "Organization"
},
{
"id": "00Tdq000006UkI5EAK",
"description": "CUSTOMER REQUESTED",
"validFor": {
"startDateTime": "2019-12-05T05:30:00.000+05:30",
"endDateTime": "2019-12-05T06:30:00.000+05:30"
},
"role": "requestedAppointment",
"@type": "RelatedEntity",
"@referredType": "Appointment"
}
],
"relatedParty": [
{
"id": "003dq000004yL0rAAE",
"@schemaLocation": "https://github.com/tmforum-apis/Open_Api_And_Data_Model/blob/master/schemas/EngagedParty/RelatedPartyWithContactInfo.schema.json",
"@type": "RelatedPartyWithContactInfo",
"role":"contact",
"@referredType": "Individual",
"contactMedium": [
{
"@referredType": "TelephoneMedium",
"mediumType": "TelephoneNumber",
"characteristic": {
"phoneNumber": "8879541292"
}
}
]
}
],
"troubleTicketCharacteristic": [
{
"name": "externalStatus",
"value": "assigned"
}
]
}